7.3.2 创建数字币限定金额扫码支付订单（商户自定义汇率）

#简要描述： 数字币充值业务接口，用户通过扫描二维码的方式将 USDT（Tether）充值到他们的数字钱包账户（商户自定义汇率，需登录商户后台设置）

• 请求方式: POST
• 请求接口: https://网关域名/wallet-trade-merchant/v1/receive/blockchain/fixed/custom/rate/create
• 请求媒体类型( JSON 数据格式 )Content-Type: application/json

请求参数

参数名称	类型	必填	参数含义	参数说明
key	string	是	商户 key	apiKey
localOrderId	string	是	商户平台本地订单号	商户平台本地生成唯一订单号
localUserId	string	否	商户平台本地用户ID	商户平台本地用户ID
notifyUrl	string	否	回调地址	下单成功后，由 API 回调通知商户的地址（回调详情说明在最下方）
successRedirectUrl	string	否	跳转地址	成功后自动跳转地址
userCurrency	string	是	币种	需要用户支付的币种(钱包支持数字币种)
quoteCurrency	string	是	自定义报价币种	自定义报价币种（需登录商户后台设置报价币种汇率）
quoteAmount	number	是	自定义报价金额	订单计价金额
isBlockchain	boolean	否	是否返回区块链信息（默认false）	当为true时，回调请求会携带订单链上交易信息
networkLimits	array	否	主网	指定的支付主网，如 TRON、BSC、POLYGON、ETHEREUM
expireSecond	Long	否	过期时间戳（秒）
sign	string	是	签名	详情见签名算法

请求 json 样例

{
  "key": "dNNTJZpgFVWlYrVv",
  "localOrderId": "CONANTEST01140",
  "userCurrency": "USDT",
  "quoteCurrency": "CNY",
  "quoteAmount": "20",
  "networkLimits": ["TRON", "BSC"],
  "sign": "401c6541a4ba99794981233794f29a56"
}

响应 json 示例

{
  "code": 0,
  "success": true,
  "message": null,
  "data": {
    "orderId": 474108977750213,
    "localUserId": null,
    "localOrderId": "CONANTEST01140",
    "orderType": "PAYMENT",
    "orderBizType": "PAYMENT_FIXED_DIGITAL_SCAN",
    "paymentUrl": "https://dxpay.dxstudio.org/fixed-amount-pay/JhpkZduKiBYPyn3WhobAWJnzwLMmvWxGwqrBFTRRDBf6VX7UUJeqL52ERxX6",
    "publicKey": "JhpkZduKiBYPyn3WhobAWJnzwLMmvWxGwqrBFTRRDBf6VX7UUJeqL52ERxX6",
    "currency": "CNY",
    "userCurrency": "USDT",
    "amount": "20",
    "userReceivableAmount": "1.83",
    "rate": "10.9",
    "rateExpression": "1USDT≈10.9CNY"
  }
}

返回的 paymentUrl 弹出支付页面，如下图：

data 参数说明

参数名称	类型	参数含义	参数说明
orderId	string	订单 ID
localUserId	string	商户本地用户 ID
localOrderId	string	商户本地订单号
orderType	enum	订单类型	PAYMENT:支付订单 | WITHDRAW:提款订单
orderBizType	enum	订单业务类型	orderBizType 类型说明如下
paymentUrl	string	支付地址
publicKey	string	密钥	公共访问密钥
currency	string	订单币种
userCurrency	string	用户支付币种
amount	string	订单金额
userReceivableAmount	string	用户应付金额
rate	string	汇率
rateExpression	string	订单汇率表达式

orderBizType 类型说明：

1、PAYMENT_WALLET_SCAN MINPAY钱包扫码支付
2、PAYMENT_TRANSFER 数字币绑定地址直充
3、PAYMENT_ANY_DIGITAL_SCAN 数字币任意金额扫码支付
4、WITHDRAW_WALLET 提款至MINPAY钱包
5、WITHDRAW_ANY_DIGITAL_WALLET 提款数字币至任意钱包
6、PAYMENT_FIXED_DIGITAL_SCAN 数字币限定金额扫码支付
7、BATCH_PAY 批量代付

回调详情说明

回调的方式是：POST application/json

回调参数 json 化示例

{
  "amount": 1,
  "bizType": "PAYMENT_FIXED_DIGITAL_SCAN",
  "blockchain": {
    "network": "TRON",
    "receiverAddress": "TA1jptT16DssYWVGdVyFWxonku6hWK7En3",
    "senderAddress": "TPutFhYUQnrRxHSmKVwjp55vgk9QY6r5nS",
    "txId": "24d0d0e5d417bd2195c45d64724760ae47fc3b359ee31c5fedf25b40f3584b36"
  },
  "currency": "USDT",
  "extra": {
    "quoteAmount": 10,
    "quoteCurrency": "CNY",
    "quotePrice": 10
  },
  "key": "h3cS7dBltRU4W1wD",
  "localOrderId": "2820",
  "merchantActualAmount": 22.72,
  "merchantCurrency": "CNY",
  "merchantId": 303122065665,
  "merchantPaidAmount": 7.33,
  "notifyTime": 1736744168370,
  "orderCreateTime": 1731572133082,
  "orderId": "273124814912907",
  "sign": "699806308a9e055114c378671b0d2a15",
  "status": "SUCCESS",
  "type": "WITHDRAW",
  "userAmount": 1,
  "userCurrency": "USDT",
  "userReceivableAmount": 1
}

参数名称	类型	参与签名	参数含义	参数说明
amount	decimal	是	订单金额
bizType	enum	是	订单类型
blockchain	object	是	链交易信息	当下单请求参数isBlockchain为true，回调请求会携带此对象信息。（只涉及链上交易时，isBlockchain参数会生效）
└network	String	是	主网
└receiverAddress	String	是	接收地址
└senderAddress	decimal	是	发送地址
└txId	String	是	交易ID
currency	String	是	币种
key	String	是	商户 key
localOrderId	String	是	本地订单号
merchantActualAmount	decimal	是	商户实际收款金额
merchantCurrency	String	是	商户收款币种	默认币种
merchantId	String	是	商户号
merchantPaidAmount	decimal	是	商户收款金额
merchantUserId	String	是	用户 id
notifyTime	long	是	回调时间
orderCreateTime	long	是	订单创建时间
orderId	String	是	订单号
status	String	是	支付状态
type	String	是	订单类型	PAYMENT:支付 WITHDRAW：提款
userAmount	decimal	是	用户付款金额
userCurrency	String	是	用户支付币种
sign	String	否	md5 签名	详情看签名算法
extra	object	是	包含一下参数
└quoteAmount	number	是	订单报价金额
└quoteCurrency	number	是	订单报价币种
└quotePrice	string	是	订单报价价格
userReceivableAmount	string	是	用户应付金额

当您收到回调通知后，请在处理完成后直接返回字符串 success，表示已成功接收并处理该消息。 系统在收到 success 响应后，将不再对该笔回调进行重复发送。 若未收到期望响应（未返回 success 或返回异常），系统将按照阶梯式重试机制重新发送回调通知，最多重试 14 次。 当前重试时间间隔依次为： 15s, 15s, 30s,180s, 600s, 1200s, 1800s, 1800s, 1800s,3600s,10800s,10800s,21600s, 21600s